<?xml version="1.0" encoding="ascii"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
          "DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
<head>
  <title>Priithon.usefulP</title>
  <link rel="stylesheet" href="epydoc.css" type="text/css" />
  <script type="text/javascript" src="epydoc.js"></script>
</head>

<body bgcolor="white" text="black" link="blue" vlink="#204080"
      alink="#204080">
<!-- ==================== NAVIGATION BAR ==================== -->
<table class="navbar" border="0" width="100%" cellpadding="0"
       bgcolor="#a0c0ff" cellspacing="0">
  <tr valign="middle">
  <!-- Home link -->
      <th>&nbsp;&nbsp;&nbsp;<a
        href="Priithon-module.html">Home</a>&nbsp;&nbsp;&nbsp;</th>

  <!-- Tree link -->
      <th>&nbsp;&nbsp;&nbsp;<a
        href="module-tree.html">Trees</a>&nbsp;&nbsp;&nbsp;</th>

  <!-- Index link -->
      <th>&nbsp;&nbsp;&nbsp;<a
        href="identifier-index.html">Indices</a>&nbsp;&nbsp;&nbsp;</th>

  <!-- Help link -->
      <th>&nbsp;&nbsp;&nbsp;<a
        href="help.html">Help</a>&nbsp;&nbsp;&nbsp;</th>

  <!-- Project homepage -->
      <th class="navbar" align="right" width="100%">
        <table border="0" cellpadding="0" cellspacing="0">
          <tr><th class="navbar" align="center"
            ><a class="navbar" target="_top" href="http://code.google.com/p/priithon">Priithon</a></th>
          </tr></table></th>
  </tr>
</table>
<table width="100%" cellpadding="0" cellspacing="0">
  <tr valign="top">
    <td width="100%">
      <span class="breadcrumbs">
        <a href="Priithon-module.html">Package&nbsp;Priithon</a> ::
        Module&nbsp;usefulP
      </span>
    </td>
    <td>
      <table cellpadding="0" cellspacing="0">
        <!-- hide/show private -->
        <tr><td align="right"><span class="options">[<a href="javascript:void(0);" class="privatelink"
    onclick="toggle_private();">hide&nbsp;private</a>]</span></td></tr>
        <tr><td align="right"><span class="options"
            >[<a href="frames.html" target="_top">frames</a
            >]&nbsp;|&nbsp;<a href="Priithon.usefulP-module.html"
            target="_top">no&nbsp;frames</a>]</span></td></tr>
      </table>
    </td>
  </tr>
</table>
<!-- ==================== MODULE DESCRIPTION ==================== -->
<h1 class="epydoc">Module usefulP</h1><p class="nomargin-top"><span class="codelink"><a href="Priithon.usefulP-pysrc.html">source&nbsp;code</a></span></p>
<p>plot functions in Y module: Y.plot...</p>

<hr />
<div class="fields">      <p><strong>Author:</strong>
        Sebastian Haase &lt;seb.haase+Priithon@gmail.com&gt;
      </p>
      <p><strong>License:</strong>
        BSD license - see LICENSE file
      </p>
</div><!-- ==================== FUNCTIONS ==================== -->
<a name="section-Functions"></a>
<table class="summary" border="1" cellpadding="3"
       cellspacing="0" width="100%" bgcolor="white">
<tr bgcolor="#70b0f0" class="table-header">
  <td colspan="2" class="table-header">
    <table border="0" cellpadding="0" cellspacing="0" width="100%">
      <tr valign="top">
        <td align="left"><span class="table-header">Functions</span></td>
        <td align="right" valign="top"
         ><span class="options">[<a href="#section-Functions"
         class="privatelink" onclick="toggle_private();"
         >hide private</a>]</span></td>
      </tr>
    </table>
  </td>
</tr>
<tr>
    <td width="15%" align="right" valign="top" class="summary">
      <span class="summary-type">&nbsp;</span>
    </td><td class="summary">
      <table width="100%" cellpadding="0" cellspacing="0" border="0">
        <tr>
          <td><span class="summary-sig"><a href="Priithon.usefulP-module.html#plotColorsDefault" class="summary-sig-name">plotColorsDefault</a>(<span class="summary-sig-arg">colString</span>=<span class="summary-sig-default"><code class="variable-quote">'</code><code class="variable-string">rgbkcm</code><code class="variable-quote">'</code></span>)</span><br />
      set or get default colors used for graph plotting</td>
          <td align="right" valign="top">
            <span class="codelink"><a href="Priithon.usefulP-pysrc.html#plotColorsDefault">source&nbsp;code</a></span>
            
          </td>
        </tr>
      </table>
      
    </td>
  </tr>
<tr class="private">
    <td width="15%" align="right" valign="top" class="summary">
      <span class="summary-type">&nbsp;</span>
    </td><td class="summary">
      <table width="100%" cellpadding="0" cellspacing="0" border="0">
        <tr>
          <td><span class="summary-sig"><a name="_col"></a><span class="summary-sig-name">_col</span>(<span class="summary-sig-arg">c</span>,
        <span class="summary-sig-arg">overwriteHold</span>=<span class="summary-sig-default">False</span>)</span></td>
          <td align="right" valign="top">
            <span class="codelink"><a href="Priithon.usefulP-pysrc.html#_col">source&nbsp;code</a></span>
            
          </td>
        </tr>
      </table>
      
    </td>
  </tr>
<tr class="private">
    <td width="15%" align="right" valign="top" class="summary">
      <span class="summary-type">&nbsp;</span>
    </td><td class="summary">
      <table width="100%" cellpadding="0" cellspacing="0" border="0">
        <tr>
          <td><span class="summary-sig"><a href="Priithon.usefulP-module.html#_getFig" class="summary-sig-name" onclick="show_private();">_getFig</a>(<span class="summary-sig-arg">figureNo</span>)</span><br />
      figureNo can be ...</td>
          <td align="right" valign="top">
            <span class="codelink"><a href="Priithon.usefulP-pysrc.html#_getFig">source&nbsp;code</a></span>
            
          </td>
        </tr>
      </table>
      
    </td>
  </tr>
<tr>
    <td width="15%" align="right" valign="top" class="summary">
      <span class="summary-type">&nbsp;</span>
    </td><td class="summary">
      <table width="100%" cellpadding="0" cellspacing="0" border="0">
        <tr>
          <td><span class="summary-sig"><a href="Priithon.usefulP-module.html#plotDatapoints" class="summary-sig-name">plotDatapoints</a>(<span class="summary-sig-arg">dataset</span>=<span class="summary-sig-default">0</span>,
        <span class="summary-sig-arg">figureNo</span>=<span class="summary-sig-default">None</span>)</span><br />
      returns array (x-vals, y-vals) --&gt; shape=(2,n)</td>
          <td align="right" valign="top">
            <span class="codelink"><a href="Priithon.usefulP-pysrc.html#plotDatapoints">source&nbsp;code</a></span>
            
          </td>
        </tr>
      </table>
      
    </td>
  </tr>
<tr>
    <td width="15%" align="right" valign="top" class="summary">
      <span class="summary-type">&nbsp;</span>
    </td><td class="summary">
      <table width="100%" cellpadding="0" cellspacing="0" border="0">
        <tr>
          <td><span class="summary-sig"><a name="plotDatasetRemove"></a><span class="summary-sig-name">plotDatasetRemove</span>(<span class="summary-sig-arg">dataset</span>=<span class="summary-sig-default">-1</span>,
        <span class="summary-sig-arg">figureNo</span>=<span class="summary-sig-default">None</span>,
        <span class="summary-sig-arg">refreshNow</span>=<span class="summary-sig-default">True</span>)</span><br />
      remove given dataset from plot adjust current color index if dataset 
      == -1</td>
          <td align="right" valign="top">
            <span class="codelink"><a href="Priithon.usefulP-pysrc.html#plotDatasetRemove">source&nbsp;code</a></span>
            
          </td>
        </tr>
      </table>
      
    </td>
  </tr>
<tr>
    <td width="15%" align="right" valign="top" class="summary">
      <span class="summary-type">&nbsp;</span>
    </td><td class="summary">
      <table width="100%" cellpadding="0" cellspacing="0" border="0">
        <tr>
          <td><span class="summary-sig"><a name="plotGetXminmax"></a><span class="summary-sig-name">plotGetXminmax</span>(<span class="summary-sig-arg">figureNo</span>=<span class="summary-sig-default">None</span>)</span><br />
      returns tuple (left, right) values on X-axis figureNo None means 
      &quot;current&quot;</td>
          <td align="right" valign="top">
            <span class="codelink"><a href="Priithon.usefulP-pysrc.html#plotGetXminmax">source&nbsp;code</a></span>
            
          </td>
        </tr>
      </table>
      
    </td>
  </tr>
<tr>
    <td width="15%" align="right" valign="top" class="summary">
      <span class="summary-type">&nbsp;</span>
    </td><td class="summary">
      <table width="100%" cellpadding="0" cellspacing="0" border="0">
        <tr>
          <td><span class="summary-sig"><a name="plotGetYminmax"></a><span class="summary-sig-name">plotGetYminmax</span>(<span class="summary-sig-arg">figureNo</span>=<span class="summary-sig-default">None</span>)</span><br />
      returns tuple (bottom,top) values on Y-axis figureNo None means 
      &quot;current&quot;</td>
          <td align="right" valign="top">
            <span class="codelink"><a href="Priithon.usefulP-pysrc.html#plotGetYminmax">source&nbsp;code</a></span>
            
          </td>
        </tr>
      </table>
      
    </td>
  </tr>
<tr>
    <td width="15%" align="right" valign="top" class="summary">
      <span class="summary-type">&nbsp;</span>
    </td><td class="summary">
      <table width="100%" cellpadding="0" cellspacing="0" border="0">
        <tr>
          <td><span class="summary-sig"><a href="Priithon.usefulP-module.html#plotSetColor" class="summary-sig-name">plotSetColor</a>(<span class="summary-sig-arg">color</span>=<span class="summary-sig-default"><code class="variable-group">(</code>255<code class="variable-op">, </code>0<code class="variable-op">, </code>0<code class="variable-group">)</code></span>,
        <span class="summary-sig-arg">dataset</span>=<span class="summary-sig-default">0</span>,
        <span class="summary-sig-arg">plotNofigureNo</span>=<span class="summary-sig-default">None</span>)</span><br />
      set color of a dataset in a figure</td>
          <td align="right" valign="top">
            <span class="codelink"><a href="Priithon.usefulP-pysrc.html#plotSetColor">source&nbsp;code</a></span>
            
          </td>
        </tr>
      </table>
      
    </td>
  </tr>
<tr>
    <td width="15%" align="right" valign="top" class="summary">
      <span class="summary-type">&nbsp;</span>
    </td><td class="summary">
      <table width="100%" cellpadding="0" cellspacing="0" border="0">
        <tr>
          <td><span class="summary-sig"><a href="Priithon.usefulP-module.html#plotRefresh" class="summary-sig-name">plotRefresh</a>(<span class="summary-sig-arg">figureNo</span>=<span class="summary-sig-default">None</span>)</span><br />
      refresh / update graph in figure</td>
          <td align="right" valign="top">
            <span class="codelink"><a href="Priithon.usefulP-pysrc.html#plotRefresh">source&nbsp;code</a></span>
            
          </td>
        </tr>
      </table>
      
    </td>
  </tr>
<tr>
    <td width="15%" align="right" valign="top" class="summary">
      <span class="summary-type">&nbsp;</span>
    </td><td class="summary">
      <table width="100%" cellpadding="0" cellspacing="0" border="0">
        <tr>
          <td><span class="summary-sig"><a href="Priithon.usefulP-module.html#plotChangeDatapoints" class="summary-sig-name">plotChangeDatapoints</a>(<span class="summary-sig-arg">xyPointArray</span>,
        <span class="summary-sig-arg">dataset</span>=<span class="summary-sig-default">0</span>,
        <span class="summary-sig-arg">figureNo</span>=<span class="summary-sig-default">None</span>,
        <span class="summary-sig-arg">refreshNow</span>=<span class="summary-sig-default">True</span>)</span><br />
      refresh / update graph in figure</td>
          <td align="right" valign="top">
            <span class="codelink"><a href="Priithon.usefulP-pysrc.html#plotChangeDatapoints">source&nbsp;code</a></span>
            
          </td>
        </tr>
      </table>
      
    </td>
  </tr>
<tr>
    <td width="15%" align="right" valign="top" class="summary">
      <span class="summary-type">&nbsp;</span>
    </td><td class="summary">
      <table width="100%" cellpadding="0" cellspacing="0" border="0">
        <tr>
          <td><span class="summary-sig"><a name="plotSetFrameTitle"></a><span class="summary-sig-name">plotSetFrameTitle</span>(<span class="summary-sig-arg">title</span>,
        <span class="summary-sig-arg">figureNo</span>=<span class="summary-sig-default">None</span>)</span><br />
      figureNo None means &quot;current&quot;</td>
          <td align="right" valign="top">
            <span class="codelink"><a href="Priithon.usefulP-pysrc.html#plotSetFrameTitle">source&nbsp;code</a></span>
            
          </td>
        </tr>
      </table>
      
    </td>
  </tr>
<tr>
    <td width="15%" align="right" valign="top" class="summary">
      <span class="summary-type">&nbsp;</span>
    </td><td class="summary">
      <table width="100%" cellpadding="0" cellspacing="0" border="0">
        <tr>
          <td><span class="summary-sig"><a name="plotSetTitle"></a><span class="summary-sig-name">plotSetTitle</span>(<span class="summary-sig-arg">title</span>=<span class="summary-sig-default"><code class="variable-quote">'</code><code class="variable-string"></code><code class="variable-quote">'</code></span>,
        <span class="summary-sig-arg">figureNo</span>=<span class="summary-sig-default">None</span>)</span><br />
      title = '' means &lt;no title&gt; figureNo None means 
      &quot;current&quot;</td>
          <td align="right" valign="top">
            <span class="codelink"><a href="Priithon.usefulP-pysrc.html#plotSetTitle">source&nbsp;code</a></span>
            
          </td>
        </tr>
      </table>
      
    </td>
  </tr>
<tr>
    <td width="15%" align="right" valign="top" class="summary">
      <span class="summary-type">&nbsp;</span>
    </td><td class="summary">
      <table width="100%" cellpadding="0" cellspacing="0" border="0">
        <tr>
          <td><span class="summary-sig"><a name="plotSetXTitle"></a><span class="summary-sig-name">plotSetXTitle</span>(<span class="summary-sig-arg">title</span>=<span class="summary-sig-default"><code class="variable-quote">'</code><code class="variable-string"></code><code class="variable-quote">'</code></span>,
        <span class="summary-sig-arg">figureNo</span>=<span class="summary-sig-default">None</span>)</span><br />
      title = '' means &lt;no title&gt; figureNo None means 
      &quot;current&quot;</td>
          <td align="right" valign="top">
            <span class="codelink"><a href="Priithon.usefulP-pysrc.html#plotSetXTitle">source&nbsp;code</a></span>
            
          </td>
        </tr>
      </table>
      
    </td>
  </tr>
<tr>
    <td width="15%" align="right" valign="top" class="summary">
      <span class="summary-type">&nbsp;</span>
    </td><td class="summary">
      <table width="100%" cellpadding="0" cellspacing="0" border="0">
        <tr>
          <td><span class="summary-sig"><a name="plotSetYTitle"></a><span class="summary-sig-name">plotSetYTitle</span>(<span class="summary-sig-arg">title</span>=<span class="summary-sig-default"><code class="variable-quote">'</code><code class="variable-string"></code><code class="variable-quote">'</code></span>,
        <span class="summary-sig-arg">figureNo</span>=<span class="summary-sig-default">None</span>)</span><br />
      title = '' means &lt;no title&gt; figureNo None means 
      &quot;current&quot;</td>
          <td align="right" valign="top">
            <span class="codelink"><a href="Priithon.usefulP-pysrc.html#plotSetYTitle">source&nbsp;code</a></span>
            
          </td>
        </tr>
      </table>
      
    </td>
  </tr>
<tr>
    <td width="15%" align="right" valign="top" class="summary">
      <span class="summary-type">&nbsp;</span>
    </td><td class="summary">
      <table width="100%" cellpadding="0" cellspacing="0" border="0">
        <tr>
          <td><span class="summary-sig"><a href="Priithon.usefulP-module.html#plotSetAxis" class="summary-sig-name">plotSetAxis</a>(<span class="summary-sig-arg">setting</span>=<span class="summary-sig-default"><code class="variable-quote">'</code><code class="variable-string">equal</code><code class="variable-quote">'</code></span>,
        <span class="summary-sig-arg">figureNo</span>=<span class="summary-sig-default">None</span>)</span><br />
      set axis settings for both X and Y axes
settings can be one of:
   'normal':
   'equal':
   'freeze':
   or 'tight' or'fit':
   or a 4-tuple (xMin,xMax,yMin,yMax)</td>
          <td align="right" valign="top">
            <span class="codelink"><a href="Priithon.usefulP-pysrc.html#plotSetAxis">source&nbsp;code</a></span>
            
          </td>
        </tr>
      </table>
      
    </td>
  </tr>
<tr>
    <td width="15%" align="right" valign="top" class="summary">
      <span class="summary-type">&nbsp;</span>
    </td><td class="summary">
      <table width="100%" cellpadding="0" cellspacing="0" border="0">
        <tr>
          <td><span class="summary-sig"><a name="plotSetXAxisFormat"></a><span class="summary-sig-name">plotSetXAxisFormat</span>(<span class="summary-sig-arg">format</span>=<span class="summary-sig-default"><code class="variable-quote">'</code><code class="variable-string">%s</code><code class="variable-quote">'</code></span>,
        <span class="summary-sig-arg">figureNo</span>=<span class="summary-sig-default">None</span>)</span><br />
      sets format to be used to label axis
`format` can either be 
   a callable - to be called for each tick value
 or
   a string, like &quot;%s&quot; or &quot;%2d&quot;, ...</td>
          <td align="right" valign="top">
            <span class="codelink"><a href="Priithon.usefulP-pysrc.html#plotSetXAxisFormat">source&nbsp;code</a></span>
            
          </td>
        </tr>
      </table>
      
    </td>
  </tr>
<tr>
    <td width="15%" align="right" valign="top" class="summary">
      <span class="summary-type">&nbsp;</span>
    </td><td class="summary">
      <table width="100%" cellpadding="0" cellspacing="0" border="0">
        <tr>
          <td><span class="summary-sig"><a name="plotSetYAxisFormat"></a><span class="summary-sig-name">plotSetYAxisFormat</span>(<span class="summary-sig-arg">format</span>=<span class="summary-sig-default"><code class="variable-quote">'</code><code class="variable-string">%s</code><code class="variable-quote">'</code></span>,
        <span class="summary-sig-arg">figureNo</span>=<span class="summary-sig-default">None</span>)</span><br />
      sets format to be used to label axis
`format` can either be 
   a callable - to be called for each tick value
 or
   a string, like &quot;%s&quot; or &quot;%2d&quot;, ...</td>
          <td align="right" valign="top">
            <span class="codelink"><a href="Priithon.usefulP-pysrc.html#plotSetYAxisFormat">source&nbsp;code</a></span>
            
          </td>
        </tr>
      </table>
      
    </td>
  </tr>
<tr>
    <td width="15%" align="right" valign="top" class="summary">
      <span class="summary-type">&nbsp;</span>
    </td><td class="summary">
      <table width="100%" cellpadding="0" cellspacing="0" border="0">
        <tr>
          <td><span class="summary-sig"><a href="Priithon.usefulP-module.html#plotSetXAxis" class="summary-sig-name">plotSetXAxis</a>(<span class="summary-sig-arg">bounds</span>=<span class="summary-sig-default"><code class="variable-group">(</code><code class="variable-quote">'</code><code class="variable-string">fit</code><code class="variable-quote">'</code><code class="variable-op">, </code><code class="variable-quote">'</code><code class="variable-string">fit</code><code class="variable-quote">'</code><code class="variable-op">, </code><code class="variable-quote">'</code><code class="variable-string">auto</code><code class="variable-quote">'</code><code class="variable-group">)</code></span>,
        <span class="summary-sig-arg">figureNo</span>=<span class="summary-sig-default">None</span>)</span><br />
      bounds is a tuple: (leftBound,rightBound, interval)
[the third is optional]
leftBound, rightBound can be one of:
   &lt;a value&gt;
   'auto'       (default) sets bound to near tickMark
   'fit'        sets bound to  &quot;tightly&quot; fit the datapoints
   None or ''   do not change
interval can be one of:
   'auto'  (default) sets tick intervals &quot;nicely&quot; (linearly spaced)
   &lt;a value&gt;</td>
          <td align="right" valign="top">
            <span class="codelink"><a href="Priithon.usefulP-pysrc.html#plotSetXAxis">source&nbsp;code</a></span>
            
          </td>
        </tr>
      </table>
      
    </td>
  </tr>
<tr>
    <td width="15%" align="right" valign="top" class="summary">
      <span class="summary-type">&nbsp;</span>
    </td><td class="summary">
      <table width="100%" cellpadding="0" cellspacing="0" border="0">
        <tr>
          <td><span class="summary-sig"><a href="Priithon.usefulP-module.html#plotSetYAxis" class="summary-sig-name">plotSetYAxis</a>(<span class="summary-sig-arg">bounds</span>=<span class="summary-sig-default"><code class="variable-group">(</code><code class="variable-quote">'</code><code class="variable-string">fit</code><code class="variable-quote">'</code><code class="variable-op">, </code><code class="variable-quote">'</code><code class="variable-string">fit</code><code class="variable-quote">'</code><code class="variable-op">, </code><code class="variable-quote">'</code><code class="variable-string">auto</code><code class="variable-quote">'</code><code class="variable-group">)</code></span>,
        <span class="summary-sig-arg">figureNo</span>=<span class="summary-sig-default">None</span>)</span><br />
      bounds is a tuple: (leftBound,rightBound, interval)
[the third is optional]
leftBound, rightBound can be one of:
   &lt;a value&gt;
   'auto'       (default) sets bound to near tickMark
   'fit'        sets bound to  &quot;tightly&quot; fit the datapoints
   None or ''   do not change
interval can be one of:
   'auto'  (default) sets tick intervals &quot;nicely&quot; (linearly spaced)
   &lt;a value&gt;</td>
          <td align="right" valign="top">
            <span class="codelink"><a href="Priithon.usefulP-pysrc.html#plotSetYAxis">source&nbsp;code</a></span>
            
          </td>
        </tr>
      </table>
      
    </td>
  </tr>
<tr>
    <td width="15%" align="right" valign="top" class="summary">
      <span class="summary-type">&nbsp;</span>
    </td><td class="summary">
      <table width="100%" cellpadding="0" cellspacing="0" border="0">
        <tr>
          <td><span class="summary-sig"><a href="Priithon.usefulP-module.html#plotSliderX" class="summary-sig-name">plotSliderX</a>(<span class="summary-sig-arg">plotXWidth</span>=<span class="summary-sig-default">None</span>,
        <span class="summary-sig-arg">xmax</span>=<span class="summary-sig-default">None</span>,
        <span class="summary-sig-arg">figureNo</span>=<span class="summary-sig-default">None</span>)</span><br />
      xmax None means 'use &quot;width&quot; of dataset'</td>
          <td align="right" valign="top">
            <span class="codelink"><a href="Priithon.usefulP-pysrc.html#plotSliderX">source&nbsp;code</a></span>
            
          </td>
        </tr>
      </table>
      
    </td>
  </tr>
<tr>
    <td width="15%" align="right" valign="top" class="summary">
      <span class="summary-type">&nbsp;</span>
    </td><td class="summary">
      <table width="100%" cellpadding="0" cellspacing="0" border="0">
        <tr>
          <td><span class="summary-sig"><a href="Priithon.usefulP-module.html#plotFigure" class="summary-sig-name">plotFigure</a>(<span class="summary-sig-arg">which_one</span>=<span class="summary-sig-default">None</span>,
        <span class="summary-sig-arg">parent</span>=<span class="summary-sig-default">None</span>)</span><br />
      if which_one = None       : start a new plot window
if which_one is 'integer' : select that figure as active</td>
          <td align="right" valign="top">
            <span class="codelink"><a href="Priithon.usefulP-pysrc.html#plotFigure">source&nbsp;code</a></span>
            
          </td>
        </tr>
      </table>
      
    </td>
  </tr>
<tr>
    <td width="15%" align="right" valign="top" class="summary">
      <span class="summary-type">&nbsp;</span>
    </td><td class="summary">
      <table width="100%" cellpadding="0" cellspacing="0" border="0">
        <tr>
          <td><span class="summary-sig"><a name="plotFigureGetNo"></a><span class="summary-sig-name">plotFigureGetNo</span>(<span class="summary-sig-arg">createNewIfNeeded</span>=<span class="summary-sig-default">False</span>)</span><br />
      return figureNo of current figure</td>
          <td align="right" valign="top">
            <span class="codelink"><a href="Priithon.usefulP-pysrc.html#plotFigureGetNo">source&nbsp;code</a></span>
            
          </td>
        </tr>
      </table>
      
    </td>
  </tr>
<tr>
    <td width="15%" align="right" valign="top" class="summary">
      <span class="summary-type">&nbsp;</span>
    </td><td class="summary">
      <table width="100%" cellpadding="0" cellspacing="0" border="0">
        <tr>
          <td><span class="summary-sig"><a name="plotRaise"></a><span class="summary-sig-name">plotRaise</span>(<span class="summary-sig-arg">figureNo</span>=<span class="summary-sig-default">None</span>)</span><br />
      bring current plotframe to the top</td>
          <td align="right" valign="top">
            <span class="codelink"><a href="Priithon.usefulP-pysrc.html#plotRaise">source&nbsp;code</a></span>
            
          </td>
        </tr>
      </table>
      
    </td>
  </tr>
<tr>
    <td width="15%" align="right" valign="top" class="summary">
      <span class="summary-type">&nbsp;</span>
    </td><td class="summary">
      <table width="100%" cellpadding="0" cellspacing="0" border="0">
        <tr>
          <td><span class="summary-sig"><a name="plotClear"></a><span class="summary-sig-name">plotClear</span>(<span class="summary-sig-arg">figureNo</span>=<span class="summary-sig-default">None</span>)</span><br />
      clear all graphs and images from current plot</td>
          <td align="right" valign="top">
            <span class="codelink"><a href="Priithon.usefulP-pysrc.html#plotClear">source&nbsp;code</a></span>
            
          </td>
        </tr>
      </table>
      
    </td>
  </tr>
<tr>
    <td width="15%" align="right" valign="top" class="summary">
      <span class="summary-type">&nbsp;</span>
    </td><td class="summary">
      <table width="100%" cellpadding="0" cellspacing="0" border="0">
        <tr>
          <td><span class="summary-sig"><a name="plotClose"></a><span class="summary-sig-name">plotClose</span>(<span class="summary-sig-arg">which_one</span>=<span class="summary-sig-default">None</span>)</span><br />
      close plot window</td>
          <td align="right" valign="top">
            <span class="codelink"><a href="Priithon.usefulP-pysrc.html#plotClose">source&nbsp;code</a></span>
            
          </td>
        </tr>
      </table>
      
    </td>
  </tr>
<tr>
    <td width="15%" align="right" valign="top" class="summary">
      <span class="summary-type">&nbsp;</span>
    </td><td class="summary">
      <table width="100%" cellpadding="0" cellspacing="0" border="0">
        <tr>
          <td><span class="summary-sig"><a href="Priithon.usefulP-module.html#plotxy" class="summary-sig-name">plotxy</a>(<span class="summary-sig-arg">arr1</span>,
        <span class="summary-sig-arg">arr2</span>=<span class="summary-sig-default">None</span>,
        <span class="summary-sig-arg">c</span>=<span class="summary-sig-default"><code class="variable-quote">'</code><code class="variable-string">-+</code><code class="variable-quote">'</code></span>,
        <span class="summary-sig-arg">logY</span>=<span class="summary-sig-default">False</span>,
        <span class="summary-sig-arg">logX</span>=<span class="summary-sig-default">False</span>,
        <span class="summary-sig-arg">hold</span>=<span class="summary-sig-default">None</span>,
        <span class="summary-sig-arg">smartTranspose</span>=<span class="summary-sig-default">True</span>,
        <span class="summary-sig-arg">logZeroOffset</span>=<span class="summary-sig-default">0.01</span>,
        <span class="summary-sig-arg">figureNo</span>=<span class="summary-sig-default">None</span>)</span><br />
      arr1 is a &quot;table&quot; of x,y1,...,yn values
if arr2 is given than arr1 contains only the x values
        and arr2 is &quot;table&quot; y1,...,y2
if hold is not None:
    if hold is True
        turn plothold on before drawing
    else
        turn plothold off before drawing
otherwise
    do nothing about current hold setting</td>
          <td align="right" valign="top">
            <span class="codelink"><a href="Priithon.usefulP-pysrc.html#plotxy">source&nbsp;code</a></span>
            
          </td>
        </tr>
      </table>
      
    </td>
  </tr>
<tr>
    <td width="15%" align="right" valign="top" class="summary">
      <span class="summary-type">&nbsp;</span>
    </td><td class="summary">
      <table width="100%" cellpadding="0" cellspacing="0" border="0">
        <tr>
          <td><span class="summary-sig"><a href="Priithon.usefulP-module.html#ploty" class="summary-sig-name">ploty</a>(<span class="summary-sig-arg">arrY</span>,
        <span class="summary-sig-arg">c</span>=<span class="summary-sig-default"><code class="variable-quote">'</code><code class="variable-string">-+</code><code class="variable-quote">'</code></span>,
        <span class="summary-sig-arg">logY</span>=<span class="summary-sig-default">False</span>,
        <span class="summary-sig-arg">logX</span>=<span class="summary-sig-default">False</span>,
        <span class="summary-sig-arg">hold</span>=<span class="summary-sig-default">None</span>,
        <span class="summary-sig-arg">smartTranspose</span>=<span class="summary-sig-default">True</span>,
        <span class="summary-sig-arg">logZeroOffset</span>=<span class="summary-sig-default">0.01</span>,
        <span class="summary-sig-arg">figureNo</span>=<span class="summary-sig-default">None</span>)</span><br />
      arrY is a &quot;table&quot; of y1,...,yn values
x-values of 0,1,2,3,4 are used as needed</td>
          <td align="right" valign="top">
            <span class="codelink"><a href="Priithon.usefulP-pysrc.html#ploty">source&nbsp;code</a></span>
            
          </td>
        </tr>
      </table>
      
    </td>
  </tr>
<tr>
    <td width="15%" align="right" valign="top" class="summary">
      <span class="summary-type">&nbsp;</span>
    </td><td class="summary">
      <table width="100%" cellpadding="0" cellspacing="0" border="0">
        <tr>
          <td><span class="summary-sig"><a name="plothold"></a><span class="summary-sig-name">plothold</span>(<span class="summary-sig-arg">on</span>=<span class="summary-sig-default">1</span>,
        <span class="summary-sig-arg">figureNo</span>=<span class="summary-sig-default">None</span>)</span></td>
          <td align="right" valign="top">
            <span class="codelink"><a href="Priithon.usefulP-pysrc.html#plothold">source&nbsp;code</a></span>
            
          </td>
        </tr>
      </table>
      
    </td>
  </tr>
<tr>
    <td width="15%" align="right" valign="top" class="summary">
      <span class="summary-type">&nbsp;</span>
    </td><td class="summary">
      <table width="100%" cellpadding="0" cellspacing="0" border="0">
        <tr>
          <td><span class="summary-sig"><a name="plotsave"></a><span class="summary-sig-name">plotsave</span>(<span class="summary-sig-arg">fn</span>=<span class="summary-sig-default">None</span>,
        <span class="summary-sig-arg">format</span>=<span class="summary-sig-default"><code class="variable-quote">'</code><code class="variable-string">png</code><code class="variable-quote">'</code></span>,
        <span class="summary-sig-arg">figureNo</span>=<span class="summary-sig-default">None</span>)</span><br />
      save image of plot into a file if `fn` is None calls FN() for you</td>
          <td align="right" valign="top">
            <span class="codelink"><a href="Priithon.usefulP-pysrc.html#plotsave">source&nbsp;code</a></span>
            
          </td>
        </tr>
      </table>
      
    </td>
  </tr>
<tr>
    <td width="15%" align="right" valign="top" class="summary">
      <span class="summary-type">&nbsp;</span>
    </td><td class="summary">
      <table width="100%" cellpadding="0" cellspacing="0" border="0">
        <tr>
          <td><span class="summary-sig"><a href="Priithon.usefulP-module.html#plotsave_csv" class="summary-sig-name">plotsave_csv</a>(<span class="summary-sig-arg">fn</span>=<span class="summary-sig-default">None</span>,
        <span class="summary-sig-arg">sep</span>=<span class="summary-sig-default"><code class="variable-quote">'</code><code class="variable-string">\t</code><code class="variable-quote">'</code></span>,
        <span class="summary-sig-arg">transpose</span>=<span class="summary-sig-default">True</span>,
        <span class="summary-sig-arg">figureNo</span>=<span class="summary-sig-default">None</span>)</span><br />
      save comma separated value table into a text file
use sep (instead of comma) to separate values
if transpose:
    values are written in columns for each dataset
    x1 y1 ...other datasets to the right...</td>
          <td align="right" valign="top">
            <span class="codelink"><a href="Priithon.usefulP-pysrc.html#plotsave_csv">source&nbsp;code</a></span>
            
          </td>
        </tr>
      </table>
      
    </td>
  </tr>
<tr>
    <td width="15%" align="right" valign="top" class="summary">
      <span class="summary-type">&nbsp;</span>
    </td><td class="summary">
      <table width="100%" cellpadding="0" cellspacing="0" border="0">
        <tr>
          <td><span class="summary-sig"><a href="Priithon.usefulP-module.html#plotsave_csv_singleXcolumn" class="summary-sig-name">plotsave_csv_singleXcolumn</a>(<span class="summary-sig-arg">fn</span>=<span class="summary-sig-default">None</span>,
        <span class="summary-sig-arg">sep</span>=<span class="summary-sig-default"><code class="variable-quote">'</code><code class="variable-string">\t</code><code class="variable-quote">'</code></span>,
        <span class="summary-sig-arg">figureNo</span>=<span class="summary-sig-default">None</span>)</span><br />
      save comma separated value table into a text file
use sep (instead of comma) to separate values</td>
          <td align="right" valign="top">
            <span class="codelink"><a href="Priithon.usefulP-pysrc.html#plotsave_csv_singleXcolumn">source&nbsp;code</a></span>
            
          </td>
        </tr>
      </table>
      
    </td>
  </tr>
<tr>
    <td width="15%" align="right" valign="top" class="summary">
      <span class="summary-type">&nbsp;</span>
    </td><td class="summary">
      <table width="100%" cellpadding="0" cellspacing="0" border="0">
        <tr>
          <td><span class="summary-sig"><a name="plotMouse__graph2window"></a><span class="summary-sig-name">plotMouse__graph2window</span>(<span class="summary-sig-arg">pts</span>,
        <span class="summary-sig-arg">figureNo</span>=<span class="summary-sig-default">None</span>)</span><br />
      convert graph coordinates to wxWindow coordinates pts: one or list of
      many x,y coordinate(s)</td>
          <td align="right" valign="top">
            <span class="codelink"><a href="Priithon.usefulP-pysrc.html#plotMouse__graph2window">source&nbsp;code</a></span>
            
          </td>
        </tr>
      </table>
      
    </td>
  </tr>
<tr>
    <td width="15%" align="right" valign="top" class="summary">
      <span class="summary-type">&nbsp;</span>
    </td><td class="summary">
      <table width="100%" cellpadding="0" cellspacing="0" border="0">
        <tr>
          <td><span class="summary-sig"><a name="plotMouse__window2graph"></a><span class="summary-sig-name">plotMouse__window2graph</span>(<span class="summary-sig-arg">p</span>,
        <span class="summary-sig-arg">figureNo</span>=<span class="summary-sig-default">None</span>)</span><br />
      convert wxWindow coordinates to graph coordinates pts: one or list of
      many x,y coordinate(s)</td>
          <td align="right" valign="top">
            <span class="codelink"><a href="Priithon.usefulP-pysrc.html#plotMouse__window2graph">source&nbsp;code</a></span>
            
          </td>
        </tr>
      </table>
      
    </td>
  </tr>
<tr>
    <td width="15%" align="right" valign="top" class="summary">
      <span class="summary-type">&nbsp;</span>
    </td><td class="summary">
      <table width="100%" cellpadding="0" cellspacing="0" border="0">
        <tr>
          <td><span class="summary-sig"><a href="Priithon.usefulP-module.html#plotMouseEventHandlerSet" class="summary-sig-name">plotMouseEventHandlerSet</a>(<span class="summary-sig-arg">handler</span>=<span class="summary-sig-default">None</span>,
        <span class="summary-sig-arg">figureNo</span>=<span class="summary-sig-default">None</span>)</span><br />
      if handler is None: reset to default mouse handler (zooming)</td>
          <td align="right" valign="top">
            <span class="codelink"><a href="Priithon.usefulP-pysrc.html#plotMouseEventHandlerSet">source&nbsp;code</a></span>
            
          </td>
        </tr>
      </table>
      
    </td>
  </tr>
<tr>
    <td width="15%" align="right" valign="top" class="summary">
      <span class="summary-type">&nbsp;</span>
    </td><td class="summary">
      <table width="100%" cellpadding="0" cellspacing="0" border="0">
        <tr>
          <td><span class="summary-sig"><a href="Priithon.usefulP-module.html#plotMouseEventHandlerSet_fct_XY_OnLeft" class="summary-sig-name">plotMouseEventHandlerSet_fct_XY_OnLeft</a>(<span class="summary-sig-arg">fct_XY</span>,
        <span class="summary-sig-arg">onlyOnClick</span>=<span class="summary-sig-default">True</span>,
        <span class="summary-sig-arg">figureNo</span>=<span class="summary-sig-default">None</span>)</span><br />
      shortcut for handler functions as shown as example in
mouseEventHandlerSet;
if onlyOnClick is False, call fct when LeftIsDown,
     i.e.</td>
          <td align="right" valign="top">
            <span class="codelink"><a href="Priithon.usefulP-pysrc.html#plotMouseEventHandlerSet_fct_XY_OnLeft">source&nbsp;code</a></span>
            
          </td>
        </tr>
      </table>
      
    </td>
  </tr>
</table>
<!-- ==================== VARIABLES ==================== -->
<a name="section-Variables"></a>
<table class="summary" border="1" cellpadding="3"
       cellspacing="0" width="100%" bgcolor="white">
<tr bgcolor="#70b0f0" class="table-header">
  <td colspan="2" class="table-header">
    <table border="0" cellpadding="0" cellspacing="0" width="100%">
      <tr valign="top">
        <td align="left"><span class="table-header">Variables</span></td>
        <td align="right" valign="top"
         ><span class="options">[<a href="#section-Variables"
         class="privatelink" onclick="toggle_private();"
         >hide private</a>]</span></td>
      </tr>
    </table>
  </td>
</tr>
<tr>
    <td width="15%" align="right" valign="top" class="summary">
      <span class="summary-type">&nbsp;</span>
    </td><td class="summary">
        <a name="plot_defaultStyle"></a><span class="summary-name">plot_defaultStyle</span> = <code title="'-+'"><code class="variable-quote">'</code><code class="variable-string">-+</code><code class="variable-quote">'</code></code>
    </td>
  </tr>
<tr>
    <td width="15%" align="right" valign="top" class="summary">
      <span class="summary-type">&nbsp;</span>
    </td><td class="summary">
        <a name="plot_colors"></a><span class="summary-name">plot_colors</span> = <code title="'rgbkcm'"><code class="variable-quote">'</code><code class="variable-string">rgbkcm</code><code class="variable-quote">'</code></code>
    </td>
  </tr>
</table>
<!-- ==================== FUNCTION DETAILS ==================== -->
<a name="section-FunctionDetails"></a>
<table class="details" border="1" cellpadding="3"
       cellspacing="0" width="100%" bgcolor="white">
<tr bgcolor="#70b0f0" class="table-header">
  <td colspan="2" class="table-header">
    <table border="0" cellpadding="0" cellspacing="0" width="100%">
      <tr valign="top">
        <td align="left"><span class="table-header">Function Details</span></td>
        <td align="right" valign="top"
         ><span class="options">[<a href="#section-FunctionDetails"
         class="privatelink" onclick="toggle_private();"
         >hide private</a>]</span></td>
      </tr>
    </table>
  </td>
</tr>
</table>
<a name="plotColorsDefault"></a>
<div>
<table class="details" border="1" cellpadding="3"
       cellspacing="0" width="100%" bgcolor="white">
<tr><td>
  <table width="100%" cellpadding="0" cellspacing="0" border="0">
  <tr valign="top"><td>
  <h3 class="epydoc"><span class="sig"><span class="sig-name">plotColorsDefault</span>(<span class="sig-arg">colString</span>=<span class="sig-default"><code class="variable-quote">'</code><code class="variable-string">rgbkcm</code><code class="variable-quote">'</code></span>)</span>
  </h3>
  </td><td align="right" valign="top"
    ><span class="codelink"><a href="Priithon.usefulP-pysrc.html#plotColorsDefault">source&nbsp;code</a></span>&nbsp;
    </td>
  </tr></table>
  
  <pre class="literalblock">

set or get default colors used for graph plotting

color-cycle: these colors are used in sequence when multiple graphs in one figure-window
colors:
  r - red;   g - green;  b - blue
  k - black; c - cyan;   m - magenta

if colString False: 
   return current colString (global `plot_colors`)

</pre>
  <dl class="fields">
  </dl>
</td></tr></table>
</div>
<a name="_getFig"></a>
<div class="private">
<table class="details" border="1" cellpadding="3"
       cellspacing="0" width="100%" bgcolor="white">
<tr><td>
  <table width="100%" cellpadding="0" cellspacing="0" border="0">
  <tr valign="top"><td>
  <h3 class="epydoc"><span class="sig"><span class="sig-name">_getFig</span>(<span class="sig-arg">figureNo</span>)</span>
  </h3>
  </td><td align="right" valign="top"
    ><span class="codelink"><a href="Priithon.usefulP-pysrc.html#_getFig">source&nbsp;code</a></span>&nbsp;
    </td>
  </tr></table>
  
  <pre class="literalblock">

figureNo can be 
   None:   return  active figure
   an int: return  figure with that id
   a figure object: return that
   (TODO: an id-string)

</pre>
  <dl class="fields">
  </dl>
</td></tr></table>
</div>
<a name="plotDatapoints"></a>
<div>
<table class="details" border="1" cellpadding="3"
       cellspacing="0" width="100%" bgcolor="white">
<tr><td>
  <table width="100%" cellpadding="0" cellspacing="0" border="0">
  <tr valign="top"><td>
  <h3 class="epydoc"><span class="sig"><span class="sig-name">plotDatapoints</span>(<span class="sig-arg">dataset</span>=<span class="sig-default">0</span>,
        <span class="sig-arg">figureNo</span>=<span class="sig-default">None</span>)</span>
  </h3>
  </td><td align="right" valign="top"
    ><span class="codelink"><a href="Priithon.usefulP-pysrc.html#plotDatapoints">source&nbsp;code</a></span>&nbsp;
    </td>
  </tr></table>
  
  <p>returns array (x-vals, y-vals) --&gt; shape=(2,n)</p>
  <p>figureNo None means &quot;current&quot;</p>
  <dl class="fields">
  </dl>
</td></tr></table>
</div>
<a name="plotSetColor"></a>
<div>
<table class="details" border="1" cellpadding="3"
       cellspacing="0" width="100%" bgcolor="white">
<tr><td>
  <table width="100%" cellpadding="0" cellspacing="0" border="0">
  <tr valign="top"><td>
  <h3 class="epydoc"><span class="sig"><span class="sig-name">plotSetColor</span>(<span class="sig-arg">color</span>=<span class="sig-default"><code class="variable-group">(</code>255<code class="variable-op">, </code>0<code class="variable-op">, </code>0<code class="variable-group">)</code></span>,
        <span class="sig-arg">dataset</span>=<span class="sig-default">0</span>,
        <span class="sig-arg">plotNofigureNo</span>=<span class="sig-default">None</span>)</span>
  </h3>
  </td><td align="right" valign="top"
    ><span class="codelink"><a href="Priithon.usefulP-pysrc.html#plotSetColor">source&nbsp;code</a></span>&nbsp;
    </td>
  </tr></table>
  
  <p>set color of a dataset in a figure</p>
  <p>figureNo None means &quot;current&quot;</p>
  <dl class="fields">
  </dl>
</td></tr></table>
</div>
<a name="plotRefresh"></a>
<div>
<table class="details" border="1" cellpadding="3"
       cellspacing="0" width="100%" bgcolor="white">
<tr><td>
  <table width="100%" cellpadding="0" cellspacing="0" border="0">
  <tr valign="top"><td>
  <h3 class="epydoc"><span class="sig"><span class="sig-name">plotRefresh</span>(<span class="sig-arg">figureNo</span>=<span class="sig-default">None</span>)</span>
  </h3>
  </td><td align="right" valign="top"
    ><span class="codelink"><a href="Priithon.usefulP-pysrc.html#plotRefresh">source&nbsp;code</a></span>&nbsp;
    </td>
  </tr></table>
  
  <p>refresh / update graph in figure</p>
  <p>figureNo None means &quot;current&quot;</p>
  <dl class="fields">
  </dl>
</td></tr></table>
</div>
<a name="plotChangeDatapoints"></a>
<div>
<table class="details" border="1" cellpadding="3"
       cellspacing="0" width="100%" bgcolor="white">
<tr><td>
  <table width="100%" cellpadding="0" cellspacing="0" border="0">
  <tr valign="top"><td>
  <h3 class="epydoc"><span class="sig"><span class="sig-name">plotChangeDatapoints</span>(<span class="sig-arg">xyPointArray</span>,
        <span class="sig-arg">dataset</span>=<span class="sig-default">0</span>,
        <span class="sig-arg">figureNo</span>=<span class="sig-default">None</span>,
        <span class="sig-arg">refreshNow</span>=<span class="sig-default">True</span>)</span>
  </h3>
  </td><td align="right" valign="top"
    ><span class="codelink"><a href="Priithon.usefulP-pysrc.html#plotChangeDatapoints">source&nbsp;code</a></span>&nbsp;
    </td>
  </tr></table>
  
  <p>refresh / update graph in figure</p>
  <p>figureNo None means &quot;current&quot;</p>
  <p>HACK / FIXME only change line, ignore markers</p>
  <dl class="fields">
  </dl>
</td></tr></table>
</div>
<a name="plotSetAxis"></a>
<div>
<table class="details" border="1" cellpadding="3"
       cellspacing="0" width="100%" bgcolor="white">
<tr><td>
  <table width="100%" cellpadding="0" cellspacing="0" border="0">
  <tr valign="top"><td>
  <h3 class="epydoc"><span class="sig"><span class="sig-name">plotSetAxis</span>(<span class="sig-arg">setting</span>=<span class="sig-default"><code class="variable-quote">'</code><code class="variable-string">equal</code><code class="variable-quote">'</code></span>,
        <span class="sig-arg">figureNo</span>=<span class="sig-default">None</span>)</span>
  </h3>
  </td><td align="right" valign="top"
    ><span class="codelink"><a href="Priithon.usefulP-pysrc.html#plotSetAxis">source&nbsp;code</a></span>&nbsp;
    </td>
  </tr></table>
  
  <pre class="literalblock">

set axis settings for both X and Y axes
settings can be one of:
   'normal':
   'equal':
   'freeze':
   or 'tight' or'fit':
   or a 4-tuple (xMin,xMax,yMin,yMax)
  
figureNo None means &quot;current&quot;

</pre>
  <dl class="fields">
  </dl>
</td></tr></table>
</div>
<a name="plotSetXAxis"></a>
<div>
<table class="details" border="1" cellpadding="3"
       cellspacing="0" width="100%" bgcolor="white">
<tr><td>
  <table width="100%" cellpadding="0" cellspacing="0" border="0">
  <tr valign="top"><td>
  <h3 class="epydoc"><span class="sig"><span class="sig-name">plotSetXAxis</span>(<span class="sig-arg">bounds</span>=<span class="sig-default"><code class="variable-group">(</code><code class="variable-quote">'</code><code class="variable-string">fit</code><code class="variable-quote">'</code><code class="variable-op">, </code><code class="variable-quote">'</code><code class="variable-string">fit</code><code class="variable-quote">'</code><code class="variable-op">, </code><code class="variable-quote">'</code><code class="variable-string">auto</code><code class="variable-quote">'</code><code class="variable-group">)</code></span>,
        <span class="sig-arg">figureNo</span>=<span class="sig-default">None</span>)</span>
  </h3>
  </td><td align="right" valign="top"
    ><span class="codelink"><a href="Priithon.usefulP-pysrc.html#plotSetXAxis">source&nbsp;code</a></span>&nbsp;
    </td>
  </tr></table>
  
  <pre class="literalblock">

bounds is a tuple: (leftBound,rightBound, interval)
[the third is optional]
leftBound, rightBound can be one of:
   &lt;a value&gt;
   'auto'       (default) sets bound to near tickMark
   'fit'        sets bound to  &quot;tightly&quot; fit the datapoints
   None or ''   do not change
interval can be one of:
   'auto'  (default) sets tick intervals &quot;nicely&quot; (linearly spaced)
   &lt;a value&gt;


figureNo None means &quot;current&quot;

</pre>
  <dl class="fields">
  </dl>
</td></tr></table>
</div>
<a name="plotSetYAxis"></a>
<div>
<table class="details" border="1" cellpadding="3"
       cellspacing="0" width="100%" bgcolor="white">
<tr><td>
  <table width="100%" cellpadding="0" cellspacing="0" border="0">
  <tr valign="top"><td>
  <h3 class="epydoc"><span class="sig"><span class="sig-name">plotSetYAxis</span>(<span class="sig-arg">bounds</span>=<span class="sig-default"><code class="variable-group">(</code><code class="variable-quote">'</code><code class="variable-string">fit</code><code class="variable-quote">'</code><code class="variable-op">, </code><code class="variable-quote">'</code><code class="variable-string">fit</code><code class="variable-quote">'</code><code class="variable-op">, </code><code class="variable-quote">'</code><code class="variable-string">auto</code><code class="variable-quote">'</code><code class="variable-group">)</code></span>,
        <span class="sig-arg">figureNo</span>=<span class="sig-default">None</span>)</span>
  </h3>
  </td><td align="right" valign="top"
    ><span class="codelink"><a href="Priithon.usefulP-pysrc.html#plotSetYAxis">source&nbsp;code</a></span>&nbsp;
    </td>
  </tr></table>
  
  <pre class="literalblock">

bounds is a tuple: (leftBound,rightBound, interval)
[the third is optional]
leftBound, rightBound can be one of:
   &lt;a value&gt;
   'auto'       (default) sets bound to near tickMark
   'fit'        sets bound to  &quot;tightly&quot; fit the datapoints
   None or ''   do not change
interval can be one of:
   'auto'  (default) sets tick intervals &quot;nicely&quot; (linearly spaced)
   &lt;a value&gt;


figureNo None means &quot;current&quot;

</pre>
  <dl class="fields">
  </dl>
</td></tr></table>
</div>
<a name="plotSliderX"></a>
<div>
<table class="details" border="1" cellpadding="3"
       cellspacing="0" width="100%" bgcolor="white">
<tr><td>
  <table width="100%" cellpadding="0" cellspacing="0" border="0">
  <tr valign="top"><td>
  <h3 class="epydoc"><span class="sig"><span class="sig-name">plotSliderX</span>(<span class="sig-arg">plotXWidth</span>=<span class="sig-default">None</span>,
        <span class="sig-arg">xmax</span>=<span class="sig-default">None</span>,
        <span class="sig-arg">figureNo</span>=<span class="sig-default">None</span>)</span>
  </h3>
  </td><td align="right" valign="top"
    ><span class="codelink"><a href="Priithon.usefulP-pysrc.html#plotSliderX">source&nbsp;code</a></span>&nbsp;
    </td>
  </tr></table>
  
  <p>xmax None means 'use &quot;width&quot; of dataset'</p>
  <p>plotXWidth None mean xmax/10 figureNo None means 
  &quot;current&quot;</p>
  <dl class="fields">
  </dl>
</td></tr></table>
</div>
<a name="plotFigure"></a>
<div>
<table class="details" border="1" cellpadding="3"
       cellspacing="0" width="100%" bgcolor="white">
<tr><td>
  <table width="100%" cellpadding="0" cellspacing="0" border="0">
  <tr valign="top"><td>
  <h3 class="epydoc"><span class="sig"><span class="sig-name">plotFigure</span>(<span class="sig-arg">which_one</span>=<span class="sig-default">None</span>,
        <span class="sig-arg">parent</span>=<span class="sig-default">None</span>)</span>
  </h3>
  </td><td align="right" valign="top"
    ><span class="codelink"><a href="Priithon.usefulP-pysrc.html#plotFigure">source&nbsp;code</a></span>&nbsp;
    </td>
  </tr></table>
  
  <pre class="literalblock">
if which_one = None       : start a new plot window
if which_one is 'integer' : select that figure as active

if `parent` is not None:
   set figure's frame's parent to `parent`
   (calling Reparent() if figure already exists
    this might not succeed !)

</pre>
  <dl class="fields">
  </dl>
</td></tr></table>
</div>
<a name="plotxy"></a>
<div>
<table class="details" border="1" cellpadding="3"
       cellspacing="0" width="100%" bgcolor="white">
<tr><td>
  <table width="100%" cellpadding="0" cellspacing="0" border="0">
  <tr valign="top"><td>
  <h3 class="epydoc"><span class="sig"><span class="sig-name">plotxy</span>(<span class="sig-arg">arr1</span>,
        <span class="sig-arg">arr2</span>=<span class="sig-default">None</span>,
        <span class="sig-arg">c</span>=<span class="sig-default"><code class="variable-quote">'</code><code class="variable-string">-+</code><code class="variable-quote">'</code></span>,
        <span class="sig-arg">logY</span>=<span class="sig-default">False</span>,
        <span class="sig-arg">logX</span>=<span class="sig-default">False</span>,
        <span class="sig-arg">hold</span>=<span class="sig-default">None</span>,
        <span class="sig-arg">smartTranspose</span>=<span class="sig-default">True</span>,
        <span class="sig-arg">logZeroOffset</span>=<span class="sig-default">0.01</span>,
        <span class="sig-arg">figureNo</span>=<span class="sig-default">None</span>)</span>
  </h3>
  </td><td align="right" valign="top"
    ><span class="codelink"><a href="Priithon.usefulP-pysrc.html#plotxy">source&nbsp;code</a></span>&nbsp;
    </td>
  </tr></table>
  
  <pre class="literalblock">

arr1 is a &quot;table&quot; of x,y1,...,yn values
if arr2 is given than arr1 contains only the x values
        and arr2 is &quot;table&quot; y1,...,y2
if hold is not None:
    if hold is True
        turn plothold on before drawing
    else
        turn plothold off before drawing
otherwise
    do nothing about current hold setting

if logY or logX the respective axis is shown in log10 (after applying abs() and adding logZeroOffset)

if smartTranspose:
    transpose tables if that makes fewer graphs with each more data-points

if figureNo is not None:
   use that figure instead and switch back to current afterwards

</pre>
  <dl class="fields">
  </dl>
</td></tr></table>
</div>
<a name="ploty"></a>
<div>
<table class="details" border="1" cellpadding="3"
       cellspacing="0" width="100%" bgcolor="white">
<tr><td>
  <table width="100%" cellpadding="0" cellspacing="0" border="0">
  <tr valign="top"><td>
  <h3 class="epydoc"><span class="sig"><span class="sig-name">ploty</span>(<span class="sig-arg">arrY</span>,
        <span class="sig-arg">c</span>=<span class="sig-default"><code class="variable-quote">'</code><code class="variable-string">-+</code><code class="variable-quote">'</code></span>,
        <span class="sig-arg">logY</span>=<span class="sig-default">False</span>,
        <span class="sig-arg">logX</span>=<span class="sig-default">False</span>,
        <span class="sig-arg">hold</span>=<span class="sig-default">None</span>,
        <span class="sig-arg">smartTranspose</span>=<span class="sig-default">True</span>,
        <span class="sig-arg">logZeroOffset</span>=<span class="sig-default">0.01</span>,
        <span class="sig-arg">figureNo</span>=<span class="sig-default">None</span>)</span>
  </h3>
  </td><td align="right" valign="top"
    ><span class="codelink"><a href="Priithon.usefulP-pysrc.html#ploty">source&nbsp;code</a></span>&nbsp;
    </td>
  </tr></table>
  
  <pre class="literalblock">

arrY is a &quot;table&quot; of y1,...,yn values
x-values of 0,1,2,3,4 are used as needed

if hold is not None:
    if hold is True
        turn plothold on before drawing
    else
        turn plothold off before drawing
otherwise
    do nothing about current hold setting

if logY or logX the respective axis is shown in log10 (after applying abs() and adding logZeroOffset)

if smartTranspose:
    transpose tables if that makes fewer graphs with each more data-points

if figureNo is not None:
   use that figure instead and switch back to current afterwards

</pre>
  <dl class="fields">
  </dl>
</td></tr></table>
</div>
<a name="plotsave_csv"></a>
<div>
<table class="details" border="1" cellpadding="3"
       cellspacing="0" width="100%" bgcolor="white">
<tr><td>
  <table width="100%" cellpadding="0" cellspacing="0" border="0">
  <tr valign="top"><td>
  <h3 class="epydoc"><span class="sig"><span class="sig-name">plotsave_csv</span>(<span class="sig-arg">fn</span>=<span class="sig-default">None</span>,
        <span class="sig-arg">sep</span>=<span class="sig-default"><code class="variable-quote">'</code><code class="variable-string">\t</code><code class="variable-quote">'</code></span>,
        <span class="sig-arg">transpose</span>=<span class="sig-default">True</span>,
        <span class="sig-arg">figureNo</span>=<span class="sig-default">None</span>)</span>
  </h3>
  </td><td align="right" valign="top"
    ><span class="codelink"><a href="Priithon.usefulP-pysrc.html#plotsave_csv">source&nbsp;code</a></span>&nbsp;
    </td>
  </tr></table>
  
  <pre class="literalblock">

save comma separated value table into a text file
use sep (instead of comma) to separate values
if transpose:
    values are written in columns for each dataset
    x1 y1 ...other datasets to the right...
    x2 y2 ...other datasets to the right...
    x3 y3 ...other datasets to the right...
    .........
else:
    x1  x2  x3  ...
    y1  y2  y3  ...
    ... other datasets below...

if `fn` is None calls FN() for you    

</pre>
  <dl class="fields">
  </dl>
</td></tr></table>
</div>
<a name="plotsave_csv_singleXcolumn"></a>
<div>
<table class="details" border="1" cellpadding="3"
       cellspacing="0" width="100%" bgcolor="white">
<tr><td>
  <table width="100%" cellpadding="0" cellspacing="0" border="0">
  <tr valign="top"><td>
  <h3 class="epydoc"><span class="sig"><span class="sig-name">plotsave_csv_singleXcolumn</span>(<span class="sig-arg">fn</span>=<span class="sig-default">None</span>,
        <span class="sig-arg">sep</span>=<span class="sig-default"><code class="variable-quote">'</code><code class="variable-string">\t</code><code class="variable-quote">'</code></span>,
        <span class="sig-arg">figureNo</span>=<span class="sig-default">None</span>)</span>
  </h3>
  </td><td align="right" valign="top"
    ><span class="codelink"><a href="Priithon.usefulP-pysrc.html#plotsave_csv_singleXcolumn">source&nbsp;code</a></span>&nbsp;
    </td>
  </tr></table>
  
  <pre class="literalblock">

save comma separated value table into a text file
use sep (instead of comma) to separate values

all x values found in any dataset are compiled into one (sorted) column

values are written in columns for each dataset
    x_1 y1_1 y2_1 ...other datasets to the right...
    x_2 y2_2 y2_2 ...other datasets to the right...
    x_3 y3_3 y2_3 ...other datasets to the right...
    .........
if a dataset has no corresponding y value for 
     a given x value (present in another dataset)
     the respective y entry is left blank.

if `fn` is None calls FN() for you    

</pre>
  <dl class="fields">
  </dl>
</td></tr></table>
</div>
<a name="plotMouseEventHandlerSet"></a>
<div>
<table class="details" border="1" cellpadding="3"
       cellspacing="0" width="100%" bgcolor="white">
<tr><td>
  <table width="100%" cellpadding="0" cellspacing="0" border="0">
  <tr valign="top"><td>
  <h3 class="epydoc"><span class="sig"><span class="sig-name">plotMouseEventHandlerSet</span>(<span class="sig-arg">handler</span>=<span class="sig-default">None</span>,
        <span class="sig-arg">figureNo</span>=<span class="sig-default">None</span>)</span>
  </h3>
  </td><td align="right" valign="top"
    ><span class="codelink"><a href="Priithon.usefulP-pysrc.html#plotMouseEventHandlerSet">source&nbsp;code</a></span>&nbsp;
    </td>
  </tr></table>
  
  <pre class="literalblock">

if handler is None: reset to default mouse handler (zooming)

exampler `handler`:
  def h(evt):
     p = evt.GetPosition()
     if evt.LeftDown():
        print plotMouse__window2graph(p)

</pre>
  <dl class="fields">
  </dl>
</td></tr></table>
</div>
<a name="plotMouseEventHandlerSet_fct_XY_OnLeft"></a>
<div>
<table class="details" border="1" cellpadding="3"
       cellspacing="0" width="100%" bgcolor="white">
<tr><td>
  <table width="100%" cellpadding="0" cellspacing="0" border="0">
  <tr valign="top"><td>
  <h3 class="epydoc"><span class="sig"><span class="sig-name">plotMouseEventHandlerSet_fct_XY_OnLeft</span>(<span class="sig-arg">fct_XY</span>,
        <span class="sig-arg">onlyOnClick</span>=<span class="sig-default">True</span>,
        <span class="sig-arg">figureNo</span>=<span class="sig-default">None</span>)</span>
  </h3>
  </td><td align="right" valign="top"
    ><span class="codelink"><a href="Priithon.usefulP-pysrc.html#plotMouseEventHandlerSet_fct_XY_OnLeft">source&nbsp;code</a></span>&nbsp;
    </td>
  </tr></table>
  
  <pre class="literalblock">

shortcut for handler functions as shown as example in
mouseEventHandlerSet;
if onlyOnClick is False, call fct when LeftIsDown,
     i.e. also while moving when button kept down

example `fct_XY`
  def fct_XY(x,y):
     print x,y

</pre>
  <dl class="fields">
  </dl>
</td></tr></table>
</div>
<br />
<!-- ==================== NAVIGATION BAR ==================== -->
<table class="navbar" border="0" width="100%" cellpadding="0"
       bgcolor="#a0c0ff" cellspacing="0">
  <tr valign="middle">
  <!-- Home link -->
      <th>&nbsp;&nbsp;&nbsp;<a
        href="Priithon-module.html">Home</a>&nbsp;&nbsp;&nbsp;</th>

  <!-- Tree link -->
      <th>&nbsp;&nbsp;&nbsp;<a
        href="module-tree.html">Trees</a>&nbsp;&nbsp;&nbsp;</th>

  <!-- Index link -->
      <th>&nbsp;&nbsp;&nbsp;<a
        href="identifier-index.html">Indices</a>&nbsp;&nbsp;&nbsp;</th>

  <!-- Help link -->
      <th>&nbsp;&nbsp;&nbsp;<a
        href="help.html">Help</a>&nbsp;&nbsp;&nbsp;</th>

  <!-- Project homepage -->
      <th class="navbar" align="right" width="100%">
        <table border="0" cellpadding="0" cellspacing="0">
          <tr><th class="navbar" align="center"
            ><a class="navbar" target="_top" href="http://code.google.com/p/priithon">Priithon</a></th>
          </tr></table></th>
  </tr>
</table>
<table border="0" cellpadding="0" cellspacing="0" width="100%%">
  <tr>
    <td align="left" class="footer">
    Generated by Epydoc 3.0.1 on Mon Nov 22 14:59:33 2010
    </td>
    <td align="right" class="footer">
      <a target="mainFrame" href="http://epydoc.sourceforge.net"
        >http://epydoc.sourceforge.net</a>
    </td>
  </tr>
</table>

<script type="text/javascript">
  <!--
  // Private objects are initially displayed (because if
  // javascript is turned off then we want them to be
  // visible); but by default, we want to hide them.  So hide
  // them unless we have a cookie that says to show them.
  checkCookie();
  // -->
</script>
</body>
</html>
